home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ifl / TIFFReadTile.z / TIFFReadTile
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddTTTTiiiilllleeee((((3333TTTT))))  IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll   TTTTIIIIFFFFFFFFRRRReeeeaaaaddddTTTTiiiilllleeee((((3333TTTT))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFReadTile - read and decode a tile of data from an open TIFF file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  13.      ttttssssiiiizzzzeeee____tttt TTTTIIIIFFFFFFFFRRRReeeeaaaaddddTTTTiiiilllleeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, ttttddddaaaattttaaaa____tttt bbbbuuuuffff,,,, uuuuiiiinnnntttt33332222 xxxx,,,, uuuuiiiinnnntttt33332222 yyyy,,,, uuuuiiiinnnntttt33332222
  14.      zzzz,,,, ttttssssaaaammmmpppplllleeee____tttt ssssaaaammmmpppplllleeee))))
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      Return the data for the tile _c_o_n_t_a_i_n_i_n_g the specified coordinates.  The
  18.      data placed in _b_u_f are returned decompressed and, typically, in the
  19.      native byte- and bit-ordering, but are otherwise packed (see further
  20.      below).  The buffer must be large enough to hold an entire tile of data.
  21.      Applications should call the routine _T_I_F_F_T_i_l_e_S_i_z_e to find out the size
  22.      (in bytes) of a tile buffer.  The _x and _y parameters are always used by
  23.      _T_I_F_F_R_e_a_d_T_i_l_e.  The _z parameter is used if the image is deeper than 1
  24.      slice (_I_m_a_g_e_D_e_p_t_h>1).  The _s_a_m_p_l_e parameter is used only if data are
  25.      organized in separate planes (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).
  26.  
  27. NNNNOOOOTTTTEEEESSSS
  28.      The library attempts to hide bit- and byte-ordering differences between
  29.      the image and the native machine by converting data to the native machine
  30.      order.  Bit reversal is done if the _F_i_l_l_O_r_d_e_r tag is opposite to the
  31.      native machine bit order.  16- and 32-bit samples are automatically
  32.      byte-swapped if the file was written with a byte order opposite to the
  33.      native machine byte order,
  34.  
  35. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  36.      _T_I_F_F_R_e_a_d_T_i_l_e returns -1 if it detects an error; otherwise the number of
  37.      bytes in the decoded tile is returned.
  38.  
  39. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  40.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      _l_i_b_t_i_f_f(3T), _T_I_F_F_C_h_e_c_k_T_i_l_e(3T), _T_I_F_F_C_o_m_p_u_t_e_T_i_l_e(3T), _T_I_F_F_O_p_e_n(3T),
  44.      _T_I_F_F_R_e_a_d_E_n_c_o_d_e_d_T_i_l_e(3T), _T_I_F_F_R_e_a_d_R_a_w_T_i_l_e(3T)
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.